home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / nlstat13.arc / NLSTATS.DOC < prev    next >
Text File  |  1991-08-10  |  6KB  |  148 lines
  1.  
  2.  
  3.                          Nodelist Statistics
  4.  
  5. |                            Version 1.30
  6.  
  7.                    (C) Copyright 1991, Gary Vedvik
  8.                           FidoNet 1:102/1006
  9.  
  10.  
  11.  
  12.     PURPOSE:
  13.     ~~~~~~~~
  14.         This program was based on NETSTATS by Justin Marquez that
  15.     produced some simple statistics on the FidoNet nodelist.  That
  16.     program, however, didn't seem to display the statistics I wanted
  17.     to see so I created my own nodelist statistic utility.  NLSTATS
  18.     was the result.
  19.  
  20.         NLSTATS uses unsigned integers for all totals, so there
  21.     shouldn't be any need for updating due to variable overflows until
  22.     we get more than 65,535 nodes in the nodelist.  If that happens, I
  23.     estimate the nodelist will be no less than 5Mb in size and will
  24.     definitely mean that its time to overhaul the structure of the
  25.     nodelist file.  :)
  26.  
  27.  
  28.     USAGE:
  29.     ~~~~~~
  30.         NLSTATS supports 5 command line parameters, but does not
  31.     require any to be used.  The default operation of NLSTATS is to
  32.     open the most recent copy of NODELIST.??? from the current
  33.     directory and write the statistics report to NLSTATS.RPT, also
  34.     in the current directory.
  35.  
  36.         The following command line parameters, if used, must begin
  37.     with either a "-" or "/" character.  The case of each parameter
  38.     is not important:
  39.  
  40.  
  41.         -N<pathname>
  42.  
  43.             The path and filename of the nodelist to analyze. 
  44.             Wildcards are acceptable.  NLSTATS will use the latest
  45.             copy of the file based on its date and time stamp.
  46.  
  47.  
  48.         -O<filename>
  49.  
  50.             The output filename.  NLSTATS will attempt to write to
  51.             whatever you specify for this parameter.  Note that this
  52.             permits you to specify a device name here (eg: -oPrn if
  53.             you wish to send the report directly to the printer). 
  54.             This parameter is optional and if not specified
  55.             NLSTATS.RPT will be created in the current directory.
  56.  
  57.             Additionally, if you don't want a report file created,
  58.             use a parameter of -onul.
  59.  
  60.  
  61.         -Q
  62.  
  63.             Quiet mode.  By default, the program will display its
  64.             progress as it reads the nodelist and display everything
  65.             to the screen that goes to the report file.  Use this
  66.             option to disable this.
  67.  
  68.         -C
  69.  
  70.             Tells NLSTATS to append to the end of the report all
  71.             lines in the nodelist beginning with ";S" up until the
  72.             first line that does not begin with a semi-colon.
  73.  
  74.             The intent here is to automatically append the NOTICE
  75.             section of the nodelist to the end of the report.  Since
  76.             many of us automate our nodelist update process its
  77.             becoming too easy for us to fall behind in keeping up
  78.             with reading these notes.  This (may) help prevent this.
  79.  
  80.             Here in Net 102, I regularly post the output of NLSTATS
  81.             to one of our local sysop echos.  This option will permit
  82.             these nodelist comments to be read by more people (on a
  83.             regular basis).
  84.  
  85.         -?
  86.  
  87.             Produces a help summary of these options.
  88.  
  89.  
  90.         As far as I know, there are no bugs in this program.  However,
  91.     if you find any, feel free to send me a netmail message describing
  92.     the bug you found and I'll try to get it patched up as soon as
  93.     possible and send you a return netmail message indicating that an
  94.     update is available for file request.
  95.  
  96.  
  97.     DISCLAIMER:
  98.     ~~~~~~~~~~~
  99.         NLSTATS is provided "as is", without warranty of any kind,
  100.     either expressed or implied.  In no event will the author be
  101.     liable to you for any damages, including any lost profits, lost
  102.     savings or other incidental or consequential damages arising out
  103.     of the use of this program.  The only thing I guarantee this
  104.     program will do is take up disk space.  :)
  105.  
  106.         NLSTATS can be freely distributed so long as 1) no fees are
  107.     charged in any form and 2) the files are not altered.  There are
  108.     no registration fees required to use this program.  Your free to
  109.     use it as you see fit so long as neither of the two above rules
  110.     are broken. 
  111.  
  112.         If you like the program, the only thing I ask is that you send
  113.     me a netmail message indicating that you like it and are using it.
  114.  
  115.  
  116.     REVISION HISTORY:
  117.     ~~~~~~~~~~~~~~~~~
  118. |   v1.30 - 8/11/91
  119. |
  120. |       Added LO and CSP entries.  CSP entries will also include
  121. |   v32/v32b if they are ever used together in the nodelist (similar
  122. |   to the HST entries).
  123.  
  124.     v1.20 - 7/14/91 - Added breakdown of total nodes by Zone.
  125.  
  126.     v1.10 - 6/30/91
  127.  
  128.         A most embarrassing bug was pointed out that caused the last
  129.     token of each nodelist line read to be ignored (or mis-compared to
  130.     be technically correct).
  131.  
  132.         Added wildcard support for the input file and removed the
  133.     requirement of the -N parameter.  NLSTATS will now look for the most
  134.     recent copy of NODELIST.??? in the current directory (where ??? is
  135.     a numeric extension).  Note that what qualifies as most "recent" is
  136.     the date and time stamp, not the files extension.
  137.  
  138.         Expanded the totals for HST Dual Standard to include the v32
  139.     and v32b models.  Note that an entry in the nodelist that includes
  140.     the HST and v32 parameters will affect the counts of both the v32
  141.     and HST D/S v32 totals.  This allows someone interested in the total
  142.     number of v32 systems in the nodelist to not have to remember to add
  143.     the HST D/S totals as well.
  144.  
  145.  
  146.     v1.00 - 06/02/91 - Initial release.
  147. 
  148.